home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1991 …esperately Seeking Seven / Desperately Seeking Seven.2mg / Dev.CD.8 / Essentials / Tools / File.Type.Notes / FTN.E0.8004 < prev    next >
Encoding:
Text File  |  1990-04-29  |  5.2 KB  |  104 lines  |  [04] ASCII Text (0x0000)
  1. Apple II
  2. File Type Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. File Type:         $E0 (224)
  7. Auxiliary Type:    $8004
  8.  
  9. Full Name:     Davex archived volume
  10. Short Name:    Davex archived volume
  11.  
  12. Written by:    Dave Lyons                                            May 1990
  13.  
  14. Files of this type and auxiliary type contain an archived image of a ProDOS 
  15. volume.
  16. _____________________________________________________________________________
  17.  
  18. Davex is a ProDOS 8 command-line shell and program launcher compatible with 
  19. all Apple II computers that can run ProDOS 8.  It supports stuff like 
  20. wildcards, command history, print spooling, sorted directory listings, and 
  21. operations on whole directory structures.  You can add your own assembly-
  22. language commands, too.  Davex also allows (coincidentally) saving an image of 
  23. any ProDOS volume into a file and restoring it later.
  24.  
  25. For more information on Davex, contact:
  26.  
  27.     DAL Systems
  28.     P.O. Box 875
  29.     Cupertino, CA 95014
  30.     Attention:  Davex Technical Support
  31.  
  32.  
  33. File Structure
  34.  
  35. The first 512 bytes of a Davex archived volume are a header, described under 
  36. "File Format" in this Note.  After the header comes 512 bytes for each block 
  37. on the saved volume, from zero on up.  For blocks that are unused, you can 
  38. just set the file mark ahead 512 bytes instead of writing 512 zero bytes--this 
  39. way the unused blocks do not take up disk space, so the resulting file is only 
  40. a few blocks larger than the number of used blocks on the original volume.
  41.  
  42. If you run out of room while you are creating an archived volume file, close 
  43. the file and start another one with the same name on a new disk.  The 
  44. fileNumber field in the header is one in the first file, two in the second 
  45. file, and so on.
  46.  
  47. This file format is suitable for ProDOS, but it is less useful on a file 
  48. system (such as AppleShare) that does not allow for sparse files.  A Davex 
  49. archived volume file on an AppleShare server always takes up more blocks than 
  50. the original volume contains.
  51.  
  52. File Format
  53.  
  54. identityCheck (+000)    16 Bytes        These 16 bytes are 
  55.                                         required for historical reasons 
  56.                                         (there didn't used to be a special 
  57.                                         file type and auxiliary type to 
  58.                                         identify these files).  The required 
  59.                                         value is $60 followed by "VSTORE 
  60.                                         [Davex]" and a $00.  The characters 
  61.                                         have their high bits off.
  62. fileFormat    (+016)    Byte            Must be $00.  A nonzero value 
  63.                                         means the file format has changed in 
  64.                                         a way that isn't compatible with the 
  65.                                         current definition.
  66. vstoreVers    (+017)    Byte            Version of Davex vstore 
  67.                                         command used to create this file 
  68.                                         (others use $00).
  69. vrestoreVers  (+018)    Byte            Minimum version of the Davex 
  70.                                         vrestore command needed to read this 
  71.                                         file.  Use $10 (version 1.0).
  72. reserved      (+019)    13 Bytes        Reserved for future use.
  73. deviceNum     (+032)    Byte            ProDOS 8 device number of the 
  74.                                         device that this file is a volume 
  75.                                         image from.  Informational only.
  76. totalBlocks   (+033)    Long            Number of blocks on the saved 
  77.                                         volume.
  78. usedBlocks    (+037)    Long            Number of used blocks on the 
  79.                                         saved volume.
  80. volumeName    (+041)    String          Name of the saved 
  81.                                         volume, with a leading length byte.  
  82.                                         This field is 16 bytes long.  If the 
  83.                                         name is shorter than 15 characters, 
  84.                                         the remaining bytes are unused and 
  85.                                         should be zero.
  86. reserved      (+057)    7 Bytes         Reserved for future use.
  87. fileNumber    (+064)    Byte            This field contains one for 
  88.                                         the first file of an archive, n in 
  89.                                         the nth file (see above).
  90. startingBlock (+065)    Long            Block number corresponding to 
  91.                                         the data starting at offset (+512) 
  92.                                         in this file.
  93. reserved      (+069)    443 Bytes       Reserved for future use.
  94. theBlocks    (+512)     512*n Bytes     512 bytes of data for 
  95.                                         each block of the saved volume 
  96.                                         recorded in this file where n is the 
  97.                                         number of blocks.
  98.  
  99.  
  100. Further Reference
  101. _____________________________________________________________________________
  102.   o  ProDOS 8 Technical Reference
  103.  
  104.